Motionshop3D角色生成API_大模型服务平台百炼(Model Studio)-阿里云帮助中心

Motionshop-gen3d模型是一款用于辅助Motionshop的图生3D模型，可基于人物图片生成符合Motionshop视频合成要求的3D角色形象。本文档介绍了该模型提供的视频检测能力的API调用方法。

模型概览

模型名	模型简介	说明
motionshop-gen3d	motionshop-gen3d是一个特定的视频检测模型，可基于人物图片生成符合motionshop视频合成模型要求的3D角色形象。	模型邀测中，请申请通过后调用。

HTTP调用接口

功能描述

该模型用于生成符合“Motionshop 视频合成API详情”要求的3D角色形象。

前提条件

已开通百炼服务并获得API-KEY：获取API Key。

作业提交接口调用

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/3d-generation

说明

因该算法调用耗时较长，故采用异步调用的方式提交任务。
任务提交之后，系统会返回对应的作业ID，后续可通过“作业任务状态查询和结果获取接口”获取任务状态及对应结果。

入参描述

字段	类型	传参方式	必选	描述	示例值
Content-Type	String	Header	是	请求类型：application/json	application/json
Authorization	String	Header	是	API-Key，例如：Bearer d1**2a	Bearer d1**2a
X-DashScope-Async	String	Header	是	使用 enable，表明使用异步方式提交作业。	enable
model	String	Body	是	指明需要调用的视频合成模型，此处用motionshop-gen3d	motionshop-gen3d
input.image_url	String	Body	是	上传的图像url。说明上传图片仅支持HTTP链接方式，不支持本地链接方式。	http://a/a.jpg

出参描述

字段	类型	描述	示例值
output.task_id	String	提交异步任务的作业ID，实际作业结果需要通过异步任务查询接口获取。	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	提交异步任务后的作业状态。	“PENDING”
request_id	String	本次请求的系统唯一码。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

请求示例

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/3d-generation' \
--header 'Authorization: Bearer  <YOUR_API_KEY>' \
--header 'X-Dashscope-Async: enable' \
--header 'Content-Type: application/json' \
--data '{
  "model": "motionshop-gen3d",
  "input": {
    "image_url": "http://a/a.jpg"
  }
}'

响应示例

{
    "output": {
        "task_status": "PENDING",
        "task_id": "26c623d8-c6b7-418d-a936-9bfd27f5b2eb"
    },
    "request_id": "ca72fdf5-76db-9b5c-ba94-4b81b11b490d"
}

作业任务状态查询和结果获取接口

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

入参描述

字段	类型	传参方式	必选	描述	示例值
Authorization	String	Header	是	API-Key，例如：Bearer d1**2a。	Bearer d1**2a
task_id	String	Url Path	是	需要查询作业的task_id。	a8532587-fa8c-4ef8-82be-0c46b17950d1

出参描述

字段	类型	描述	示例值
output.task_id	String	查询作业的 task_id。	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	被查询作业的作业状态。	任务状态： PENDING：排队中 RUNNING：处理中 SUCCEEDED：成功 FAILED：失败 UNKNOWN：作业不存在或状态未知
output.ply_url	String	本次请求生成的3D角色文件。	"ply_url": "https://xxx/xxx"
usage.count	Int	本次请求生成3D角色的数量。	"count": 1
request_id	String	本次请求的系统唯一码。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

请求示例

curl -X GET \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
https://dashscope.aliyuncs.com/api/v1/tasks/<YOUR_TASK_ID>

响应示例

{
    "request_id": "eee28f39-5f7f-9080-8a63-d49862dd67f4",
    "output": {
        "task_id": "36c7656d-f721-4d5a-967a-1850de382509",
        "task_status": "SUCCEEDED",
        "ply_url": "https://xxx/xxx"
    },
    "usage": {
        "count": 1
    }
}

异常响应示例

{
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1", 
    	"task_status": "FAILED",
    	"code": "xxx", 
    	"message": "xxxxxx", 
    }  
}

状态码说明

大模型服务平台通用状态码请查阅：错误码。

本模型还有如下特定错误码：

http 返回码*	错误码（code）	错误信息（message）	含义说明
400	InvalidParameter	Image_url can not be empty.	image_url不能为空
400	InvalidParameter	Failed to download image, url {image_url}.	图片下载失败